home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / comms / other / amivnc / amivnc.readme < prev    next >
Text File  |  1999-06-14  |  4KB  |  88 lines
  1. Short:    Experimental VNC server for Amiga w/C source
  2. Author:   stephane.guillard@steria.fr (Stephane Guillard)
  3. Uploader: stephane.guillard@steria.fr (Stephane Guillard)
  4. Version:  0.0.10rpa
  5. Type:     comm/tcp
  6.  
  7. About VNC
  8. ---------
  9. VNC is a truly thin client protocol which enables the use of one computer
  10. (the server) from another (the client), by :
  11. - Enabling remote view of the server screen in a window on the client screen
  12. - Enabling the use of the keyboard of the client in place of the keyboard of the server
  13. - Enabling the use of the mouse of the client in place of the mouse of the server
  14. More can be found on VNC at the VNC homepage at http://www.orl.co.uk/vnc/index.html
  15.  
  16. About AmiVNC
  17. ------------
  18. I felt frustrated when I saw on a French magazine ("Dream") a CD including clients &
  19. serves for VNC for nearly all platforms, excepted a server for the Amiga.
  20. Starting from the documentation distributed with the source for VNC servers for X11 and
  21. Win32, I brought up a prototype VNC server for the Amiga. It does not pretend to be
  22. complete (by far), but it works on my setup, and I use it from a Win32 VNC client.
  23.  
  24. Requirements
  25. ------------
  26. To run AmiVNC you need :
  27. - a 15 or 16 or 24 or 32 bit RTG (CGFX or Picasso96) display for your workbench screen
  28. - a TCP-IP stack (AmiTCP or Miami(dx) or any bsdsocket.library compliant stack),
  29. - enough free ram to hold a copy of the Workbench screen,
  30. - a fast processor (a 060/50 will be perfect), otherwise the client screen update will be slow,
  31. - a computer with a VNC Client (Mac, Unix or Linux box, PC, Amiga)
  32.  
  33. To build AmiVNC you need :
  34. - SAS/C 6.5x (I use 6.58)
  35. - AmiTCP 4.3 SDK (which can be found on Aminet)
  36. - CGFx SDK (which can be found on http://www.vgr.com)
  37. - You may have to change SCOpts file to match your settings for include files
  38.   and lib directories. Edit these files with an editor.
  39.  
  40. History
  41. -------
  42. 0.0.11
  43. - Added the StopAmiVNC tool, to properly stop AmiVNC (only when it is waiting for
  44.   incoming sessions).
  45. - Enhanced keyboard support (supporting arrow keys, CONTROL, SHIFT, Lamiga = Lalt, Ramiga
  46.   = Ralt etc.). Better, but still not perfect.
  47. - Enhanced mouse support (handles ieQualifier). Better, but still not perfect : in YAM,
  48.   you can drag your messages but when they come onto a drop area, they are unselected.
  49. - Allows screen change IF new screen is the same RGB mode. I did not think it would be
  50.   very useful, but indeed I use it ! Aborts connection when screen changes if new screen
  51.   mode is different (as said somewhere above, the VNC clients abort when they receive a
  52.   mServerInitMsg message in the middle of a session, and this message is necessary to
  53.   change the resolution).
  54. - More command line options :
  55.     -e to force Big Endian flag
  56.     -(r|g|b)<value> to force red | green | blue bit shift on color encoding, useful if you
  57.      have color trouble. Legal values are 0, 8, 16, 24. Default is -r8 -g16 -b24.
  58.     -l<size> to limit network packet size when sending initial screen update. Useful if you
  59.      have too many network collisions. Default is no limit.
  60. - Speed restored under Picasso96 with screen depth = 16 bit pixels. Still slower under
  61.   CGFX or with screen depth > 2, because still using ReadPixelArray for compatibility,
  62.   and sending 4 byte pixels. Will try to fix that.
  63. - A few bug fixes.
  64.  
  65. 0.0.10ra
  66. - Deals with active screen, not necessarily Workbench (this does not mean you can open
  67.   a screen in a session !).
  68. - No longer a one shot daemon. You can re-connect. Stop with CTRL-C when the server is
  69.   waiting for connections (if you break it at another state, you may loose memory).
  70. - Corrected acquisition of raster pointer, which worked under Pic96 but not under CGFx.
  71.   Thanks to Steffen Haeuser.
  72. - Changed all color encoders to ARGB (32 bit on the wire), and ReadPixelArray(). This
  73.   is slower, but works with all CGFx and Picasso96 screen modes with depth > 8. As 
  74.   a side effect, AmiVNC is even smaller than before !
  75. - This version is successfully running on my setup, with both AmiTCP, Genesis or
  76.   Miami as a TCP stack, and Picasso96 or CFGx 4 as RTG system.
  77.  
  78. 0.0.9 :
  79. -  Fixed ObtainSocket() call, works now with Miami
  80. -  Added 24 bit pixel support
  81. -  Added Cybergraphics support
  82. -  Added setting of listening port (5900 may also be used by other softwre)
  83. -  Fixed documentation
  84. -  Still much to be done
  85.  
  86. 0.0.8mt :
  87. -  Initial release on Aminet
  88.